Entry: Warn about corner case hiding icon tooltips

https://bugzilla.gnome.org/show_bug.cgi?id=785672#c4

diff --git a/gtk/gtkentry.c b/gtk/gtkentry.c
index 8457cdf8cdc1dfcb654b579d24a6871bd624e2f9..af12425ca3b1b0aabcf741665f75d4e7562dc760 100644 (file)
--- a/gtk/gtkentry.c
+++ b/gtk/gtkentry.c
@@ -8159,6 +8159,12 @@ gtk_entry_get_icon_tooltip_text (GtkEntry             *entry,
  * See also gtk_widget_set_tooltip_text() and 
  * gtk_entry_set_icon_tooltip_markup().
  *
+ * If you unset the widget tooltip via gtk_widget_set_tooltip_text() or
+ * gtk_widget_set_tooltip_markup(), this sets GtkWidget:has-tooltip to %FALSE,
+ * which suppresses icon tooltips too. You can resolve this by then calling
+ * gtk_widget_set_has_tooltip() to set GtkWidget:has-tooltip back to %TRUE, or
+ * setting at least one non-empty tooltip on any icon achieves the same result.
+ *
  * Since: 2.16
  */
 void